home *** CD-ROM | disk | FTP | other *** search
/ Developer CD Series 1992 June: ROMin Holiday / ADC Developer CD (1992-06) (''ROMin Holiday'')_iso / Developer Connection - 06-1992.iso / Development Platforms / Apple II / Essentials / Technical.Notes / Misc / TN.MISC.016 < prev    next >
Encoding:
Text File  |  1990-08-23  |  7.4 KB  |  189 lines  |  [TEXT/pdos]
  1. Apple II
  2. Technical Notes
  3. _____________________________________________________________________________
  4.                                                   Developer Technical Support
  5.  
  6. Apple II Miscellaneous
  7. #16:    Apple II Parallel Interface Card Firmware
  8.  
  9. Written by:    Jim Luther                                           July 1990
  10.  
  11. This Technical Note documents the commands the Apple II Parallel Interface 
  12. Card's firmware supports and how to find the slot occupied by an Apple II 
  13. Parallel Interface Card.
  14. _____________________________________________________________________________
  15.  
  16. Parallel Printer Interface Card Commands
  17.  
  18. The manual that shipped with the Apple II Parallel Interface Card states 
  19. correctly that its firmware can be "identical to the firmware in the earlier 
  20. Apple II Centronics(R) Printer Card" or that it can be "identical to the 
  21. firmware in the earlier Apple II Parallel Printer Card."  However, the manual 
  22. did not correctly document the commands the Parallel Interface Cards can 
  23. handle or explain the commands clearly.
  24.  
  25. Apple II Parallel Interface Card commands, embedded in the output flow to the 
  26. card's firmware, are invoked by the BASIC output routines.  The following 
  27. three options affect the output data flow and can be controlled by sending 
  28. control codes as commands to the firmware:
  29.  
  30.     Flow option          Description
  31.     _________________________________________________________________________
  32.     Video echo           When this option is on, characters sent to the 
  33.                          printer are echoed to the video screen (via COUT1) 
  34.                          after they are sent out the parallel port.
  35.                          Note:  When an Apple II Parallel Interface Card in 
  36.                                 Parallel Printer mode is echoing characters 
  37.                                 to the video screen, the line length is 
  38.                                 forced by the card's firmware to 40.
  39.     Line length          When the video echo option is off, the line length 
  40.                          (the number of character sent before a forced 
  41.                          carriage-return) can be set in the range of 
  42.                          40 to 255 characters.  When video echo is on, the 
  43.                          line length is forced to 40.
  44.     Automatic line-feed  When this option is on, the firmware generates 
  45.                          and sends a line-feed character after each 
  46.                          carriage-return character sent.
  47.                          Note:  The automatic line-feed option can only be 
  48.                                 used when the Apple II Parallel Interface 
  49.                                 Card is in Parallel Printer mode.
  50.     _________________________________________________________________________
  51.  
  52. All commands are preceded by a command character.  The normal command 
  53. character is Control-I (ASCII $09).  If you want to change the command 
  54. character from Control-I to another command character (for example, Control-
  55. W), send Control-I, Control-W.  To change back, send Control-W, Control-I.  
  56. The format of the commands is as follows:
  57.  
  58.     {command-character} {command-string}
  59.  
  60. There are two types of commands:
  61.  
  62.   o  Commands that only change the video echo mode or the automatic 
  63.      line-feed mode.  The command format for these commands consist of 
  64.      an uppercase letter by itself (for example, I to restore the 
  65.      default settings).
  66.   o  Commands that set the line length and change the video echo mode 
  67.      or automatic line-feed mode.  The command format for these 
  68.      commands consists of a number, represented by n, followed by an 
  69.      uppercase letter with no space between the characters.  The 
  70.      number, in the range of 40 to 255 characters is the new line 
  71.      length setting  (for example, 80N to set the line length to 80).
  72.  
  73.  
  74. Commands in Centronics Printer Mode (switch 6 on)
  75.  
  76. In Centronics Printer mode, the default settings are:
  77.  
  78.   o  Video echo option on
  79.   o  40-column line length
  80.   o  Command character = Control-I
  81.  
  82. The Centronics mode firmware does not support the option to automatically 
  83. generate line-feed characters after carriage return characters.  When the 
  84. interface card is initialized in Centronics mode, it also sends the Centronics 
  85. MicroPrinter 40-column mode control character to the printer (ASCII $9E).
  86.  
  87. The following are the commands supported by the Apple II Parallel Interface 
  88. Card when it is in Centronics Printer mode:
  89.  
  90. nN
  91.  
  92.     The N command always does these two things:
  93.  
  94.       o  Turn the video echo option off.
  95.       o  Send the Centronics MicroPrinter 80-column mode control character 
  96.          to the printer (ASCII $1D).
  97.  
  98.     In addition, if the number n is included, the line length is set to n.  
  99.     The number n must be in the range of 40 to 255 characters.
  100.  
  101. nO
  102.  
  103.     The O command always does the following:
  104.  
  105.       o  Turn the video echo option on.
  106.  
  107.     In addition, if the number n is included, the line length is set to n.  
  108.     The number n must be in the range of 40 to 255 characters.
  109.  
  110.  
  111. Commands in Parallel Printer Mode (switch 6 off)
  112.  
  113. In Parallel Printer mode, the default settings are:
  114.  
  115.   o  Video echo option on
  116.   o  40-column line length
  117.   o  Automatic line-feed option on
  118.   o  Command character = Control-I
  119.  
  120. The following are the commands supported by the Apple II Parallel Interface 
  121. Card when it is in Parallel Printer mode:
  122.  
  123. I or M
  124.  
  125.     The I and the M commands always do these three things:
  126.  
  127.       o  Turn the video echo option on
  128.       o  Force the line length to 40
  129.       o  Turn the automatic line-feed option on
  130.  
  131. K or O
  132.  
  133.     The K and the O commands always do these three things:
  134.  
  135.       o  Turn the video echo option on
  136.       o  Force the line length to 40
  137.       o  Toggle the automatic line-feed option
  138.  
  139. nH or nL
  140.  
  141.     The H and the L commands always do these two things:
  142.  
  143.       o  Turn the video echo option off
  144.       o  Turn the automatic line-feed option off
  145.  
  146.     In addition, if the number n is included, the line length is set to n.  
  147.     The number n must be in the range of 40 to 255 characters.
  148.  
  149. nJ or nN
  150.  
  151.     The J and the N commands always do the following:
  152.  
  153.       o  Turn the video echo option off
  154.  
  155.     In addition, if the number n is included, the line length is set to n.  
  156.     The number n must be in the range of 40 to 255 characters.  These 
  157.     commands do not affect the automatic line-feed option setting.
  158.  
  159.  
  160. Finding the Parallel Printer Interface Card
  161.  
  162. The Apple II Parallel Interface Card manual does a good job of describing the 
  163. Apple Pascal 1.1 interface standard.  However, publishing that information in 
  164. that manual is very misleading since the Apple II Parallel Interface Card does 
  165. not support any part of the Pascal 1.1 interface standard.
  166.  
  167. However, since most programs use the Pascal 1.1 device signature bytes to 
  168. identify peripheral cards, here are the values you find in the Pascal 1.1 
  169. device signature byte addresses:
  170.  
  171.     Address    Value
  172.     ________________
  173.     $Cs05      $48
  174.     $Cs07      $48
  175.     ________________
  176.  
  177. Remember, these values do not correspond to any signature bytes defined by the 
  178. Pascal 1.1 interface standard.  The address $Cs0B contains the value $58 and 
  179. the address $Cs0C contains the value $FF, (the last two bytes of a JSR $FF58 
  180. to identify the slot) but these two locations should not be used to identify 
  181. parallel cards in general.
  182.  
  183. Further Reference
  184. _____________________________________________________________________________
  185.   o  Apple II Parallel Interface Card Manual
  186.  
  187. Centronics is a registered trademark of Centronics Data Computer Corporation.
  188.  
  189.